home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: Alpha / Whiteline Alpha.iso / tools / tospatch / gemram / shbuf13 / shbuf.ger next >
Encoding:
Text File  |  1993-06-04  |  5.3 KB  |  119 lines
  1. PROGRAMM
  2.      SHBUFnn v1.3 [4.6.1993] - 
  3.      Patchprogramm zum Vergrößern der Puffer, die das GEM zur
  4.      Verwaltung der NEWDESK.INF Datei benötigt
  5.  
  6. BESCHREIBUNG
  7.      GEM-AES und GEM-Desktop erlauben es ihre Konfiguration in
  8.      der Datei NEWDESK.INF (ehemals DESKTOP.INF) zu sichern. Beim
  9.      Neustart wird diese Datei geladen und ausgewertet. Zur internen
  10.      Verwaltung der Datei benutzt das GEM statische Puffer, deren
  11.      Größe mit der gewachsenen Leistungsfähigkeit des Desktops (ab 
  12.      GEM 3.00) nicht mitgehalten hat. So kann es leicht passieren,
  13.      daß man beim Start eines Programms die folgende Meldung erhält:
  14.        'Kein Systemspeicher mehr frei!'
  15.      SHBUF erlaubt es die entsprechenden Puffer des GEM von bisher 4KB
  16.      auf maximal 32KB zu vergrößern. Hierzu ist allerdings ein
  17.      Eingriff in den Programmcode des GEM notwendig. Dieser kann auf
  18.      zweierlei Weise erfolgen:
  19.  
  20.      a) Man installiert beim Booten des Rechners eine Kopie des GEM
  21.         im RAM, die dann vor dem Start des GEM durch SHBUF modifiziert
  22.         wird. Dies ist mit einem der folgenden Programme möglich:
  23.  
  24.         ROMRAM   TOS Beschleuniger für TTs, >256 KB,
  25.                  Mailbox Maus HH2, Freeware, A. Herzlinger, PTOS
  26.         VRAM     Virtuelle Speicherverwaltung für TTs, >256 KB,
  27.                  OverScan GbR, Berlin, Alexander Herzlinger, VRAM
  28.         ROMSPEED TOS Beschleuniger für TTs (Bestandteil von OUTSIDE
  29.                  einer virtuelle Speicherverwaltung für TTs), >256 KB,
  30.                  MAXON Verlag, Uwe Seimet, USRS
  31.         GEMRAM   GEM im RAM installieren (STs und TTs), 80-120 KB,
  32.                  Mailbox Maus MZ, Freeware, Martin Osieka, MOGR
  33.         (Beschreibung, Speicherbedarf, Bezugsquelle, Autor, Cookie)
  34.  
  35.         SHBUF gehört in diesem Fall nach diesen Programmen in den
  36.         Ordner \AUTO auf dem Bootlaufwerk und wird somit beim Booten
  37.         automatisch gestartet.
  38.         Die Programme werden nur erkannt, wenn sie das entsprechende
  39.         Cookie im Cookiejar eingetragen haben.
  40.         
  41.      b) Man benutzt SHBUF um sich eine modifizierte Kopie des TOS
  42.         zu erstellen, die anschließend auf Eproms gebrannt und in den
  43.         Rechner eingesetzt wird. Hierzu ruft man SHBUF vom Desktop
  44.         auf und erhält dann die Möglichkeit, das TOS aus den ROMs oder
  45.         einer bereits bestehenden TOS-Datei von Disk zu laden. Nachdem
  46.         SHBUF das TOS modifiziert hat, kann es abgespeichert werden.
  47.         
  48.      Standardmäßig vergrößert SHBUF die Puffer auf 16KB. Da zwei
  49.      Puffer beim Start des GEM angelegt werden, verliert man 32KB
  50.      Hauptspeicher (die anderen Puffer existieren nur temporär).
  51.      Durch Umbennen des Programms kann man diese Werte ändern. Hierzu
  52.      gibt man einfach die gewünschte Größe in KB nach dem Namen an.
  53.      Benennt man SHBUF.PRG z.B. nach SHBUF9.PRG um, werden 9KB große
  54.      Puffer angelegt und man verliert 18KB Speicher. 
  55.  
  56.      SHBUF unterstützt die folgenden GEM Versionen:
  57.  
  58.           GEM    TOS
  59.           3.00   GER 3.01
  60.           3.10   GER 2.05/3.05
  61.           3.20   GER 2.06/3.06
  62.           3.31   4.01
  63.           3.40   4.02-4.04
  64.  
  65.      SHBUF identifiziert das GEM über die Länge des GEM-TEXT-Segments.
  66.      GEM Versionen anderer Länder werden bei identischer Länge akzeptiert.
  67.  
  68. HINWEISE FÜR PROGRAMMIERER
  69.      Die Funktion shel_get() des GEM wurde so modifiziert, daß andere
  70.      Programme die Größe der Puffer ermitteln können. Die Funktion
  71.      liefert jetzt statt dem Returnwert 1 die Anzahl der gelesenen
  72.      Zeichen (maximal die Größe des Puffers). Diese Änderung 
  73.      entspricht vermutlich zukünftigen GEM-Versionen. Ein einfaches
  74.      Beispiel in C zeigt den Umgang mit der neuen Funktionalität:
  75.      
  76.        if ((buf = Malloc( 0x7FFFL)) != NULL) {
  77.          if (shel_get( buf, 2) == 2) {
  78.            bufsize = shel_get( buf, 0x7FFF);
  79.          }
  80.          else {
  81.            bufsize = 0x1060;  /* bzw. 0x400 bei GEM 1.2 */
  82.            shel_get( buf, bufsize);
  83.          };
  84.          Mshrink( buf, bufsize);
  85.        };
  86.  
  87.      Man kann jetzt die Größe des Shell-Puffers mit 
  88.        bufsize = shel_get( buf, -1);
  89.      erfragen. Problematisch ist dieser Aufruf bei bisherigen TOS-
  90.      Versionen, da dort 64KB kopiert werden.
  91.        
  92.      Das tatsächliche Ende der Daten im Puffer erkennt man übrigens
  93.      am Zeichen CTRL-Z bzw. 0.
  94.  
  95. VEKTOREN, COOKIES, ETC.
  96.      Die Patches integrieren sich in den bestehenden Programmcode
  97.      des GEM und ändern daher keine Vektoren.
  98.  
  99. ÄNDERUNGEN
  100.      v1.1: Patches für GEM Versionen aus UK bzw. USA.
  101.      v1.2: Patches für GEM 3.31 und 3.40
  102.      v1.3: Fehler in Patches für GEM 3.31 und 3.40 beseitigt
  103.  
  104. COPYRIGHT
  105.      Autor:      (\/) Martin Osieka
  106.      Anschrift:  Martin Osieka, Erbacherstr. 2, 
  107.                  64283 Darmstadt, Bundesrepublik Deutschland
  108.      Internet:   Martin_Osieka@mtk.maus.de
  109.  
  110.      Schriftlichen Anfragen bitte immer einen frankierten und
  111.      adressierten Rückumschlag beilegen.
  112.      
  113.      Das Programm SHBUF.PRG darf auf beliebige Art und Weise weiter-
  114.      verbreitet werden, solange alle Dateien des Programmpakets
  115.      beiliegen. Zum Paket gehören:
  116.        SHBUF.PRG              Patchprogramm
  117.        SHBUF.GER, SHBUF.UPL   Dokumentation und Upload-Beschreibung
  118.      Die Benutzung des Programms erfolgt auf eigene Gefahr.
  119.